home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3.2 / Ham Radio Version 3.2 (Chestnut CD-ROMs)(1993).ISO / packet / ptp / ptp.doc < prev    next >
Text File  |  1986-09-01  |  36KB  |  682 lines

  1.       +----------------------------------------------------------------+
  2.       |           WDCG -- Wake Digital Communications Group            |
  3.       |                         presents                               |
  4.       |          PTP -- Packet Terminal Program Version 2.20           |
  5.       |             with XPACKET binary transfer protocol              |
  6.       |                                                                |
  7.       |                 BY N4PY .... PUBLIC DOMAIN                     |
  8.       |          Split screen routine complements of AA4L              |
  9.       |                   Documentation by AB4S                        |
  10.       |                                                                |
  11.       +----------------------------------------------------------------+
  12.  
  13.  
  14. PTP is a terminal program written for the application layer of a packet radio
  15. station.  This program was developed specifically for use with the IBM PCjr and
  16. the TAPR TNC, but it works with other versions of the IBM PC.  PTP requires IBM
  17. DOS 2.1 or later, and will work with the monochrome adapter or the CGA adapter.
  18. 256K of RAM minimum is required to run this program.  Very little testing has
  19. been done on any other combinations.  It was developed originally for private
  20. use by Carl, N4PY, but at the urging of Ed, AB4S, Carl agreed to allow this one
  21. out of his basement.  For use with the IBM PCjr, see the note in the Appendix.
  22.  
  23. Three modes of file transfer are supported:
  24.  
  25.       1. ASCII file transfer using hardware flow control
  26.  
  27.       2. XMODEM protocol (with application error correction)
  28.  
  29.       3. XPACKET protocol (with AX.25 error correction)
  30.  
  31. There will be no discussion of the first two, as they are both well documented
  32. elsewhere.  XPACKET, however, is the invention of N4PY, and therefore not too
  33. widely known, so far.  XPACKET is a binary transfer method using speeds that
  34. are the same as ASCII dumb transfers.
  35.  
  36. XPACKET, simply put, is nothing more than a binary transfer in transparent mode
  37. so that all eight bits of each byte can be sent, and the TNC will not mistake
  38. certain characters as commands to itself.  What is the reason for XPACKET if
  39. that's all there is to it?  Well, the justification is to allow the orderly
  40. start and end of a file transfer.  Without XPACKET, each operator has to enter
  41. TNC transparent mode and coordinate the start of the transfer.  This can be
  42. awkward, as you may know.  Also, without XPACKET, there is no way for the
  43. receiver to cancel the operation when he realizes that he didn't get something
  44. right.  XPACKET tries to account for the coordination problem, and allow the
  45. "reverse channel interrupt" function to occur.
  46.  
  47. When the transfer is begun, the receiving station will automatically send a NAK
  48. character every ten seconds until it has received some data from the sender.
  49. At this time, the only character the receiver can send is a CAN (cancel) which
  50. will cause the sending station to abort the transfer.  The CAN may be sent one
  51. of two ways:
  52.  
  53.   Automatically -- if a block is received which does not agree with the byte
  54.                    count which was sent at the beginning.
  55.  
  56.   Manually -- if the receiving operator presses the Ctrl-N key.
  57.  
  58. The sending station operator can also cause the transfer to abort by pressing
  59. Ctrl-N while the transfer is taking place.  You should rarely encounter the
  60. automatic abort, but if you do, you should try starting the transfer over
  61. again.  It is likely that one of the two stations involved in the transfer has
  62. his TNC set up wrong or a PCjr is being used at the receiving station and is
  63. attempting to write his file directly to a physical diskette.  See the "Must
  64. be" list and the PCjr note in the Appendix.
  65.  
  66.  
  67. USER INSTRUCTIONS:
  68. First of all, the only thing you should have to remember is to press the Home
  69. key when you can't remember anything else about PTP options.  This will bring
  70. up a help screen which you can customize to help with your own selections.
  71. (See PTP.HLP in the FILES section of this document.)
  72.  
  73. Use a text editor (such as IBM Personal Editor II, or Professional Editor) to
  74. create a file named PTP.DEF.  This file will consist of the numbers 11 through
  75. 40 and the information you want to be sent to the TNC when the appropriate
  76. F-Key is pressed.  It will also contain information about how to route traffic
  77. listed on the WDCG PBBS and whether or not to add line feed characters after
  78. each CR during ASCII uploads.  All information in PTP.DEF is in pairs of lines
  79. with the first of each pair describing an option, and the next defining your
  80. choice for that option.
  81.  
  82. PTP.DEF might look like:
  83.  
  84. 11
  85. c wa5szl-1+cr  +----------------------------------------------+
  86.                | This file is optional.  The usage            |
  87. 12             | of the F-keys is: 11-20 = Shift -  F1 - F10  |
  88. c k4iww+cr     |                   21-30 = Ctrl  -  F1 - F10  |
  89.                |                   31-40 = Alt   -  F1 - F10  |
  90. .              +----------------------------------------------+
  91. .
  92. .
  93.  
  94. 39
  95. My name is Carl and the QTH is Cary, NC.+cr
  96.  
  97. 40
  98. 73 and good luck on packet radio.+cr
  99.  
  100. CONNECT TEXT   Default text for Alt-M connect message.  This can be
  101. xxxxx          up to 255 characters of text.
  102.  
  103. AUTOTIME       TNC-2 or Kantronics 1.6 only.  Sets TNC clock time from
  104. YES            the system clock.  Default NO.
  105.  
  106. AUTOMSG        TNC-2 only.  If YES, sets CMSG off at
  107. YES            program startup and on at exit.  Default NO.
  108.  
  109. HOLDBUF        This describes the size of the retrieve buffer lines.
  110. 128            (10 - 256) default is 128
  111.  
  112. CONNECT BELL   Connect alarm bell.  If YES, alarm will sound when connection
  113. YES            is dectected.
  114.  
  115. FOREGROUND     This describes the color choice for text on the screen.
  116. 15             (0 to 15 -- See your BASIC manual for color numbers)
  117.  
  118. BACKGROUND     This describes the background color for text screen.
  119. 0
  120.  
  121. STATE          This should be the 2-letter Postal Code for the state
  122. NC             in which you are located.
  123.  
  124. NEAR      _____________
  125. VA                     |
  126.                        |
  127. NEAR                   |____ These are the nearby states that might be expected
  128. SC                     |     to access the PBBS upon which you are placing the
  129.                        |     NTS traffic generated with PTP.
  130. NEAR      _____________|
  131. GA
  132.  
  133. SENDLF         This will determine whether or not you want PTP to add
  134. NO             LF characters after CR's during an ASCII upload.
  135.  
  136. DCD            This will determine whether or not you want PTP to use the DCD
  137. YES            line to determine when a connection occurs. If NO, receipt of
  138.                *** CONNECTED will be used to detect connection.
  139.  
  140. CONNECT FILE   The full filename to which you want connected text to be
  141. B:MYMSGS.TXT   saved when Qsave is enabled.  DCD YES is required.
  142.  
  143. NOTE:  All "keywords" used in this file (STATE, NEAR, etc.) must be in upper
  144. case.  There must not be any blank lines in this file.
  145.  
  146. NOTE:  If you do not specify FOREGROUND and BACKGROUND, they will be set to 7
  147. and 0 respectively.  Also, if FOREGROUND and BACKGROUND are set to the same
  148. value, the defaults of 7 and 0 will be used.
  149.  
  150. NOTE:  There is no order dependence to the keyword pairs used in PTP.DEF.  You
  151. may put those in any order you like as long as you keep the pairs together.
  152.  
  153. You do not have to define every possible F-key, but be sure that the number for
  154. the key you want to use precedes the text for that key.  Also, if you do not
  155. desire to set the other parameters, you do not need to include them in your
  156. PTP.DEF file.  There is no order dependence on these pairs of lines.
  157.  
  158. If you assign a string of characters to an Fkey, whether it is Alt-Fkey,
  159. Ctrl-Fkey, Shift-Fkey, or just Fkey 7 through 10, you have complete control of
  160. the string.  If you desire a CR character to follow your string you simply type
  161. "+cr" at the end of it.  If you desire an imbedded CR character, use "+cr+" at
  162. the place where you desire the CR.  To start a string with the CR character,
  163. you must put "cr+" before the string to be sent.  Also, if you want to have the
  164. Ctrl-C character as a part of the Fkey definiton, you can do that by using
  165. "cmd+", "+cmd+" or "+cmd" at the point where the Ctrl-C is to appear.
  166.  
  167. Also, you may want to create a file to be used as setup information for your
  168. TNC.  This file is optional, and may have any name you like.  It is a command
  169. list for the TNC and will be sent to the TNC when you press Alt-L from the
  170. terminal communications screen.  An example of this file would look like:
  171.  
  172. MYCALL N4PY   +----------------------------------------------+
  173. SCREENL 0     | This file is optional.  The commands are     |
  174. .             | the ones listed in the owner's manual for    |
  175. .             | your TNC.  Be sure they are set the way you  |
  176. .             | want your TNC to be configured.              |
  177. PACTIME 1     +----------------------------------------------+
  178.  
  179. A suggested method of building this file is to enable capture (via Qsave or
  180. ASCII rcv mode) and enter DISP.  Your TNC should give you a list of all the
  181. commands and the present settings for these commands.
  182.  
  183. PTP will be updated from time to time.  Check the source from which you
  184. received this copy for updated versions.  The author does not plan to release
  185. the source code, but comments and suggestions about future releases will be
  186. appreciated.
  187.  
  188. When you first RUN the program, you will be given a menu screen that will allow
  189. you to set up several operating parameters.  The numbered parameters are:
  190.  
  191.       1  Line bit rate  [1200] (300..9600)
  192.       2  Data bits  [8] (7 or 8)
  193.       3  Parity type  [n] (e,o, or n)
  194.       4  Split Screen  [y] (y or n)
  195.       5  Comm Port  [1] (1 or 2)
  196.       6  QSave File Name  [B:CAPTURE.TXT]
  197.       7  User Defined  []
  198.       8  User Defined  []
  199.       9  User Defined  []
  200.      10  User Defined  []
  201.      11  Save Setup  [PTP]
  202.      12  Load Setup  [PTP]
  203.  
  204. These parameters can all be set by the user.  The procedure for each follows:
  205.  
  206. Line bit rate --- Type 1,9600<CR> if the desired baud rate is not shown.
  207.                   The 1200 (or any other ABAUD speed you select) will become
  208.                   the operating speed for the terminal program.  Must match
  209.                   TNC.
  210.  
  211. Data bits ------- type 2,8<CR> if the desired word length is not shown.
  212.                   Must match TNC.
  213.  
  214. Parity type ----- type 3,n<CR> if desired parity is not shown.
  215.                   Even parity, Odd parity, or No parity.  Must match TNC.
  216.  
  217. Split Screen ---- type 4,y<CR> if you desire a split screen.  If you do not
  218.                   select the split screen, a full screen mode will be used
  219.                   with no keyboard buffer, and the TNC will provide echoing.
  220.  
  221. Comm Port ------- type 5,2<CR> if you need to use com2 port for TNC connection.
  222.                   Use the comm port (1 or 2) to which you connected your TNC.
  223.  
  224. QSave File Name - type 6,c:message.sav<CR> if you want to have the Quick Save
  225.                   buffer saved under a different name when you use it.  See the
  226.                   explanation of CAPTURE.TXT under "FILES USED BY PTP
  227.                   TERMINAL PROGRAM:."
  228.  
  229. User Defined ---- type 7,XXX<CR> if you want to use the F keys for frequently
  230.                   sent commands, or sequences.  Note that items 8, 9 and 10 are
  231.                   also used in the same way.  In addition to entering the se-
  232.                   quence to be sent, you can type 7,,XXXX<CR> where XXXX will
  233.                   be displayed on the terminal screen as a reminder of what you
  234.                   have attributed to that key.  This is true for keys 8, 9 and
  235.                   10 also.  Try it; you'll like it.
  236.  
  237. Save Setup ------ type 11,c:whatever<CR> to select the file name for this
  238.                   parameter file.  If you type only "11," your parameter file
  239.                   will be saved as "PTP.MOD"  All parameter files are .MOD
  240.                   so don't try to assign an extender to them -- the pgm will do
  241.                   that for you.  The file PTP.MOD will be automatically
  242.                   loaded for you when the program is started.
  243.  
  244. Load Setup ------ type 12,c:whatever<CR> to select the file name of the
  245.                   parameter file you wish to use.  The rules are the same as
  246.                   for 11 (Save Setup).
  247.  
  248. After the menu is written to the screen, you will see a list of all .MOD files
  249. present on your default disk.  You may make as many of these files (with
  250. different names) as you like.  Each can have a different personality.
  251.  
  252. You will notice that when you type nothing and simply press the Enter key, you
  253. will be placed in terminal mode and the previously selected commands will be
  254. issued.  Take a few minutes to set up your parameters the way you like to
  255. operate, then save the .MOD file before going into terminal mode.  The only
  256. prompt shown on the main menu screen is F2=Exit.  When F2 is pressed, you must
  257. also press the Enter key from this screen.
  258.  
  259. If you have selected the split-screen mode for terminal communications, you
  260. will have an inverse video bar across the screen near the bottom.  This bar
  261. contains some reference information about the status of the connect message and
  262. status of the bell action.  If you use F5 to return to DOS, depending on what
  263. you do while in DOS, this line might be gone when you return via EXIT.  If this
  264. is the case, simply press Alt-C to restore the screen divider line.
  265. The Alt-key definitions are:
  266.  
  267. Alt-A = Abort the sending of NTS traffic.  This key will also halt the loading
  268.         of TNC parameters via Alt-L.
  269.  
  270. Alt-B = Toggles the BEL character action.  This affects only whether or not the
  271.         BEL will cause the alarm to sound when received.  This has nothing to
  272.         do with the Connect alarm in PTP.DEF.
  273.  
  274. Alt-C = Clears all text from the communications screen.
  275.  
  276. Alt-D = Display the definitions for the extra 30 F-keys.  This only works if
  277.         you have the PTP.DEF file on your disk.
  278.  
  279. Alt-L = Load the TNC parameters.  You must make a file (using a text editor or
  280.         by capturing the results of DISP) which contains the setup you desire
  281.         for your TNC.  This option allows you to send the entire file of
  282.         commands to the TNC.
  283.  
  284. Alt-M = Connect message screen.  You are able to edit or remove the connect
  285.         message you have selected or set up via the PTP.DEF file.
  286.  
  287. Alt-S = Send traffic file(s).  (See Alt-W.)  When logged onto the WDCG PBBS
  288.         system, and when you are in the message section, you may send your NTS
  289.         traffic files automatically by pressing this key.  When the message is
  290.         entirely sent, the program will cause the message to be saved on the
  291.         PBBS.
  292.  
  293. Alt-T = Escape from transparent mode.  When you are in the split screen mode,
  294.         you cannot go back to command mode because the characters are buffered
  295.         until Enter is pressed.  This key will cause a one-second delay, send 3
  296.         ^C characters, and delay for one more second.
  297.  
  298. Alt-W = Write traffic.  This key will take you to a full-screen editor which
  299.         has a template for message traffic.  The last message which was written
  300.         will be displayed again, and you can overwrite the message with a new
  301.         one.  If you want to enter a field that is completely different from the
  302.         one shown, you may press Alt-E to erase the field before typing.
  303.         See "NTS TRAFFIC GENERATION:."
  304.  
  305. In addition to the Alt-keys, from either communications screen you may enter
  306. the following:
  307.  
  308. F1 = [Menu] This key will immediately take you to the main menu.
  309.  
  310. F2 = [Exit] This key will cause an end to the program.  When you press
  311.             F2, you will be asked if you are sure you want to exit.
  312.  
  313. F3 = [Rcvf] This key will allow you to receive a file from the PBBS or
  314.             from another packet station.  You are asked for the transfer
  315.             protocol desired, and the drive to store the file on.  Also
  316.             you are asked to provide a name for the file, unless it is
  317.             an XPACKET file.  You may optionally provide a name for the
  318.             XPACKET file to be received.  When you are receiving an
  319.             ASCII file, you will use F3 again to close the file.  Note
  320.             that the definition changes on the bottom of the screen when
  321.             you are receiving an ASCII file or using Qsave.
  322.  
  323. F4 = [Xmtf] This key will allow you to upload (send) a file from any
  324.             disk drive on your system.  When you are asked for the drive
  325.             be sure to include the colon (i.e. A:).  The protocol
  326.             choices are the same as for F3.
  327.  
  328. F5 = [DOS ] This key causes an immediate exit from the terminal program
  329.             and you will get the DOS prompt.  An XOFF is sent to the TNC
  330.             when you go to DOS via F5, and an XON is sent when you re-
  331.             turn.  You may do any DOS functions that your amount of mem-
  332.             ory will support.  Remember that the terminal program stays
  333.             in memory, so the usable memory available to you is reduced
  334.             by the amount required by the program.  When you are ready
  335.             to return to the terminal program, Enter "exit" at the DOS
  336.             prompt.
  337.  
  338. NOTE: If you leave the program altogether while you are in
  339.       DOS, you will have to send a CTRL-Q to the TNC to restore
  340.       normal operation.  If you return to PTP via "exit", it will
  341.       be done for you.  Each time PTP is started it issues an XON
  342.       to your TNC on the selected comm port.
  343.  
  344. NOTE: You must be running IBM PC DOS version 2.1 or higher to use F5.
  345.       Additionally, you must have COMMAND.COM somewhere that DOS can find it
  346.       or the program will abort.
  347.  
  348. F6 = [Qsve] This key will enable the "Quick Save" option.  On the main
  349.             menu you selected a file name for Quick Save.  When F6 is
  350.             pressed, the file will be appended with all that is received
  351.             until you press F6 again, or F3 to close the file.
  352.             The F6=[Qsve] will flash to let you know that the file is open.
  353.             You can, if you desire, capture any messages or monitored packets
  354.             which are being held in your TNC due to either XOFF or because of
  355.             the DTR line not being raised until the comm port is opened by
  356.             pressing F6 immediately after you do the null enter to go to the
  357.             communications screen.
  358.  
  359. F7 - F0     These keys are user defined.  See the main menu to set up
  360.             the definition and the 4-character description for these
  361.             keys.  Don't forget the rules for insertion of the CR character.
  362.             (See information under PTP.DEF for rules concerning CR character
  363.             and Ctrl-C character.)
  364.  
  365. Home        This key will cause the PTP.HLP file to be displayed, even
  366.             if you no longer have the PTP diskette installed.  When the
  367.             program is loaded, PTP.HLP is read from the diskette and
  368.             kept in storage for use when Home is pressed.
  369.  
  370. Cursor Up   These keys are used to recall previously entered text.  The
  371.    and      PTP.DEF file has an entry with the keyword HOLDBUF.  This
  372. Cursor Dn   determines the length of the recall line.  You should set
  373.             this to the same length of your PACL in the TNC.  When you
  374.             press Cursor Up, you will step through the ten-step buffer
  375.             in one direction, and pressing Cursor Dn will step the
  376.             other direction.  Experiment with this and set the length
  377.             so it is proper for your operation.  This is most useful
  378.             for correcting typographical errors in connect attempts, or
  379.             for CQ messages when in CONVERSE mode.  This function is not
  380.             available in single screen mode.
  381.  
  382. NTS TRAFFIC GENERATION:
  383. While in communications mode, if you desire to write a piece (or more) of
  384. traffic, you can simply swap screens (by pressing Alt-W) and enter the traffic
  385. on a full screen template.  The fields are defined and you can type the
  386. required information in the highlighted fields.  There are several keys which
  387. are used for NTS traffic entry.  They are:
  388.  
  389. Enter    Moves the cursor to the beginning of the next line, if multi-
  390.          line field.  If you are on the last line of a multi-line field
  391.          or if the field is a single line field, the cursor will move
  392.          to the beginning of the next field.
  393.  
  394. Tab      Moves cursor to the next field.
  395.  
  396. Shft-Tab Moves cursor to beginning of the previous field.
  397.  
  398. Alt-E    Erases to the end of the current field.
  399.  
  400. Alt-C    Returns to communications mode.
  401.  
  402. Esc      Saves the message under the name MSGnnn.MSG.
  403.          The nnn in the message name is the number field from the
  404.          message itself.  When this message has been uploaded to
  405.          the WDCG PBBS, the message file will be renamed to
  406.          MSGnnn.LOG.
  407.  
  408. Note that the check is not required in the message outline.  It will be
  409. automatically generated when the message is saved.
  410.  
  411. The TIME field is special.  It is not usual that this field be used and it will
  412. normally be left blank.  If you desire to use the time field, there are two
  413. options:
  414.  
  415.   * Put an "A" in the first position of the time field.  This will
  416.     cause PTP to enter the current time from the system clock.  There
  417.     will be a "Z" appended to the time.  Be sure your system clock is
  418.     set to UTC if you use this option.
  419.  
  420.   * You may enter the time directly in the time field.  This time will
  421.     not be changed by PTP.
  422.  
  423. The DATE field will be automatically filled in for you from the system clock so
  424. be sure that your clock is set correctly.
  425.  
  426. Later, when logged on the WDCG PBBS system, you can send your accrued traffic
  427. by going to the <M>essage menu.  After the message menu prompt, you can send
  428. messages from diskette by pressing Alt-S.  You will be shown all the unsent
  429. messages from your default diskette, and you simply enter the number of the
  430. message to be sent.  The rest is automatic (including the <S>ave function after
  431. the message is complete.  You may now send another message by pressing Alt-S
  432. again if desired.  Note that the sending of NTS message traffic can be halted
  433. (aborted) at any time by pressing Alt-A.  When each MSGnnn.MSG file is sent to
  434. the WDCG PBBS, it will be renamed to MSGnnn.LOG on your disk.
  435.  
  436. FILES USED BY PTP TERMINAL PROGRAM:
  437. PTP.EXE       The terminal emulator program.  This file can be loaded with a
  438.               .bat file, or directly from the DOS prompt by typing "PTP".
  439.  
  440. PTP.MOD       This file is used to store your main menu data.  It contains the
  441.               the personality you assigned when you configured your PTP
  442.               program.  You may have as many .MOD files as your diskette space
  443.               allows, and each can be a new personality.
  444.  
  445. PTP.DEF       This file is the only one which requires a separate editor to
  446.               create.  There is a skeleton PTP.DEF file provided with PTP which
  447.               you may use to make your own PTP.DEF.  30 additional F-KEYs are
  448.               defined by this file (Alt-Fn, Ctrl-Fn, and Shift-Fn).  This is
  449.               an optional file.  If you do not create a PTP.DEF, your F-keys
  450.               will be usable, but the extra 30 definitions will not exist.
  451.               In addition, there is information included in the PTP.DEF file
  452.               which defines screen color and routing information for NTS
  453.               traffic to be uploaded to WDCG PBBS.  See PTP.DEF under "USER
  454.               INSTRUCTIONS:" for details on this file.
  455.  
  456. MSGnnn.MSG    These files are NTS messages which have been written and are
  457.    and        ready to be sent (.MSG) and logged messages which have already
  458. MSGnnn.LOG    been sent (.LOG).  These files are generated as a part of the
  459.               NTS message process.
  460.  
  461. PTP.CKP       This file is automatically generated and contains information
  462.               about the last NTS message sent.  It is used as the default
  463.               text for beginning the next message.  Do not alter or erase this
  464.               file if you expect NTS message writing to work properly.
  465.  
  466. CAPTURE.TXT   This file is the default name which is used for QSAVE and may
  467.               be renamed at a later time, or may be changed in the main
  468.               menu.  From either full-screen terminal mode or split-screen
  469.               terminal mode, you can press F6 and this file (or other specified
  470.               file) will be opened for capture.  The file will continue to be
  471.               updated with everything received until F3 (Close file) or F6 is
  472.               again pressed.  NOTE: This file is appended each time it is
  473.               opened and the previous contents will remain.
  474.  
  475. PTP.SET       (Or other file name as desired.)  This file is used to prime your
  476.               TNC whenever you desire.  When used via Alt-L from the commun-
  477.               ications screen, the contents of this file will be sent to the
  478.               TNC in cmd: mode.  It is useful for setting, or restoring any
  479.               set of parameters you desire.  A suggested use is to capture (via
  480.               Qsave) the results of "disp" and use an editor to change this
  481.               file so that it will restore your TNC in the event of a loss of
  482.               data due to any unforeseen event.
  483.  
  484. PTP.HLP       This file is required if you desire to use the Home key for
  485.               online help.  You may, at your option, use a text editor to add
  486.               your own key definitions to the lower half of the .HLP screen.
  487.               NOTE: This file must remain the same size -- 23 lines.
  488.  
  489. PTP.SCN       This file MUST be present and MUST be unaltered in order for
  490.               PTP to run.  It must be on the default disk(ette) drive.
  491.  
  492. PTP.DOC       The documentation file (this file).  Print this file on your
  493.               system printer if you desire to have hard copy.  This file MUST
  494.               be copied along with PTP if you desire to share this program with
  495.               another Amateur Radio operator.
  496.  
  497. PTP.WRK       This is a temporary file which is generated by PTP when
  498.               downloading.  If you break, or end the program, before the down-
  499.               load is completed, you might see this file on the selected disk
  500.               drive.  You may erase it, or rename it if you desire.
  501.  
  502. MYMSGS.TXT    Or other name to your liking.  This is the file which you cause
  503.               to be created when you have CONNECT FILE in the PTP.DEF list.
  504.               This file will contain only messages that were received by you
  505.               while you were connected and F6 (Qsave) was active.  All
  506.               monitored traffic will be saved in CAPTURE.TXT.
  507.  
  508. When you are receiving an ASCII file via F3, the file will be automatically
  509. closed when a BEL character is received.  The WDCG PBBS always ends downloads
  510. with the BEL character.  Also, when PTP uploads a file, it will put a BEL
  511. character as the last byte of the file.  This can be very handy when you are
  512. transfering a file to a friend.  If he is not using PTP, have him to send you a
  513. Ctrl-G when he has finished sending the file, and it will close your disk file,
  514. thus ending the transfer.
  515.  
  516. SPLIT SCREEN CONSIDERATIONS:
  517. For the most part, split screen operation is as simple as typing on the bottom
  518. of the screen and seeing what is received on the upper part of the screen.
  519. There are, however, a few things to be considered.
  520. Because the split screen code is an assembly code routine, the BIOS calls are
  521. not handled through DOS and are not the same as the single screen mode.  The
  522. characters from the keyboard are buffered in PTP until you press the Enter key,
  523. reach the size of your buffer (which you established in .DEF file).  Since you
  524. sometimes want to send a character to the TNC without the CR, a function is
  525. provided to allow this.  If you press the Tab key, the buffer will be sent to
  526. the TNC without a trailing CR.  This is useful for entering command mode by
  527. pressing Ctrl-C and following this with a Tab.  You will be unable to send the
  528. HT character in split screen mode but this will be a very rare inconvenience.
  529. If you desire to send the Tab character it will be necessary to use the single
  530. screen mode.
  531. Also, since characters will not normally be sent to the TNC until Enter is
  532. pressed, a special key is defined to allow you to exit transparent mode from
  533. the split screen.  See the description of Alt-T for this procedure.
  534. Split-screen operation will seem a little unusual to you until you get used to
  535. the benefits.  For instance, you can be typing to someone and he might send a
  536. packet to you before you are finished.  You should see this information appear
  537. on the upper part of your screen even as you type.  Additionally, it is very
  538. nice to have all of your text on the lower part of the screen and the received
  539. information above the divider line.  It will not scroll off your screen nearly
  540. as fast this way.
  541. APPENDIX:
  542.  
  543.      XPACKET FLOW DIAGRAM
  544.  
  545. Example of an unsuccessful transfer.
  546.  
  547.       SENDER                                                RECEIVER
  548.       ------                                                --------
  549.  
  550.       Ready to send file.
  551.             <---------------------------------------------- NAK (repeated every
  552.                                                                 10 seconds un-
  553.                                                                 til data trans-
  554.                                                                 fer begins)
  555.       filename -------------------------------------------->
  556.       128 bytes data -------------------------------------->
  557.       (listens)
  558.       128 bytes data -------------------------------------->
  559.       (listens)
  560.       128 bytes data -------------------------------------->
  561.       (listens)
  562.       128 bytes data -------------------------------------->
  563.       (listens)
  564.             <---------------------------------------------- CAN
  565.  
  566.     < Both stations abort transfer and return to terminal mode. >
  567.  
  568.  
  569. Example of a successful transfer:
  570.  
  571.       SENDER                                                RECEIVER
  572.       ------                                                --------
  573.  
  574.       Ready to send file.
  575.             <---------------------------------------------- NAK (repeated every
  576.                                                                 10 seconds un-
  577.                                                                 til data trans-
  578.                                                                 fer begins)
  579.       filename -------------------------------------------->
  580.       128 bytes data -------------------------------------->
  581.       (listens)
  582.       128 bytes data -------------------------------------->
  583.       (listens)
  584.       128 bytes data -------------------------------------->
  585.       (listens)
  586.       128 bytes data -------------------------------------->
  587.       (listens)
  588.       128 bytes data -------------------------------------->
  589.       (listens)
  590.       128 bytes data -------------------------------------->
  591.       (listens)
  592.       128 bytes data -------------------------------------->
  593.       (listens)
  594.       109 bytes data -------------------------------------->
  595.       (listens)
  596.       End Of File ----------------------------------------->
  597.       < ----- Both stations return to terminal mode.------ >
  598.  
  599. NOTE: If nothing is received by the receiving station after 10 seconds, another
  600. NAK is sent.  This is repeated every 10 seconds until the file transfer is
  601. started.
  602.  
  603. NOTE: For details about the XPACKET protocol, see XPACKET.PRO, a brief
  604. description of the protocol.
  605.  
  606. What's all this about "filename"?  Well, the XPACKET protocol sends the file
  607. name in its first burst of data.  The receiving station can do with this what
  608. he will.  The PTP program shows how this can be handled by allowing the file to
  609. be saved under the name received, or under the name specified by the operator.
  610. This program gives the receiver a chance to select a name under which he wants
  611. the received file to be stored, or if you choose to let the sender provide the
  612. name, you simply press Enter at the prompt for a file name.
  613.  
  614. The PTP program uses "hardware flow control" which means that it does not honor
  615. XON or XOFF from the TNC.  Instead, it relies on the asynchronous port hardware
  616. to control the sending of data to the TNC.  When the TNC buffer becomes full,
  617. the TNC will drop CTS (Clear To Send) and the terminal will halt in its tracks
  618. until CTS is again raised.  This is how the TNC keeps from being overrun with
  619. data when the flow is otherwise continuous.
  620.  
  621. When the receiver XPACKET station is waiting to receive the first packet of
  622. data it will send NAK every 10 seconds until the first packet is received.  The
  623. last block of data will not necessarily be 128 bytes, but it will be followed
  624. by an EOF character to signify the end of the transfer.  The receiving station
  625. will then save the file according to the filespec received, or the one entered
  626. by the operator.
  627.  
  628. TNC SETUP:
  629. There are two catagories for the TNC command setup.  They are:
  630.  
  631. o  Must be     (for PTP to work as intended)
  632. o  Recommended (Local area determined)
  633.  
  634. Must Be list:
  635. ============================================================================
  636. AWLEN 8          DELETE OFF           PARITY 0 (TNC2)     CR ON
  637. AX25 ON          FLOW ON              SENDPAC $0D         COMMAND $03
  638. BKONDEL ON       PACTIME EVERY 1      XFLOW ON            8BITCONV ON (TNC2)
  639. CMDTIME 1        PARITY 4 (TNC1,Kan)  XMITOK ON           TRFLOW OFF  (TNC2)
  640. CONMODE CONVERS  START $11            STOP $13            TXFLOW OFF
  641. ============================================================================
  642.  
  643.  
  644. Recommended list:
  645. ============================================================================
  646. AUTOLF ON           BEACON EVERY 0         CONOK ON     LCOK ON
  647. CWID OFF            HBAUD 1200 (TNC1,Kan)  LFADD OFF    NEWMODE ON (TNC2,Kan)
  648. MCON OFF            RETRY 10               SCREENL 0    TXDELAY 6 (TNC1,Kan)
  649. TXDELAY 24 (TNC2)
  650. ============================================================================
  651. FINAL COMMENTS FROM WDCG:
  652.  
  653. The PCjr cannot write directly to a physical disk file during file reception.
  654. If you have enough RAM installed to define a ramdisk, you can use this as the
  655. target drive and should have no problems.
  656.  
  657. If you are using an IBM PCjr without the internal modem, you will need to run
  658. COMPCJR.COM program which is included on this diskette.  The PCjr's RS232 port
  659. is normally referred to as COM1 when the internal modem is not installed, and
  660. as COM2 when the internal modem is there.  The hardware addresses are not
  661. changed.  Be sure to select COM2 from the main menu screen if you use
  662. COMPCJR.COM.
  663.  
  664. We hope you find the Packet Terminal Program as useful and as much fun as we
  665. have.  Please feel free to pass this program along to other Amateur Radio
  666. operators and Packeteers, but please DO NOT attempt to sell this program, or to
  667. use it in any commercial way whatsoever.  This program is intended for the
  668. private use of Radio Amateurs and your cooperation is greatly appreciated in
  669. keeping it just as the author intended.  If you give a copy of PTP to someone
  670. please be sure to include this document file also.
  671.  
  672. The author of PTP assumes no responsibility for the use of this program and no
  673. guarantees are implied or intended.
  674.  
  675. Comments and suggestions are welcome, especially about the binary transfer
  676. protocols.  Send comments to:
  677.                               Carl Moreschi,N4PY
  678.                               702 Madison Ave.
  679.                               Cary, NC 27511
  680.                               919-467-8146
  681.                               or via K4IWW PBBS (145.010) in Cary, NC.
  682.